home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1995 August: Tool Chest / Dev.CD Aug 95 TC / Dev.CD Aug 95 TC.toast / Tool Chest / Development Tools & Languages / Dylan Related / Mindy / Mindy 1.2 - portable sources / INSTALL < prev    next >
Encoding:
Text File  |  1995-03-15  |  5.4 KB  |  132 lines  |  [TEXT/ttxt]
  1.     Compilation and installation instructions for Mindy.
  2.  
  3. Compiling Mindy currently requires the use of an ANSI C compiler.  We
  4. highly recommend gcc (GNU CC) if it is available.  If you are using
  5. gcc, you must use gcc 2.6.0 or later.
  6.  
  7. To configure Mindy for your system, simply type ``./configure'' and
  8. wait for configure to figure things out.  When that is done, begin the
  9. compilation by typing ``make'' (or ``gmake'' if you have GNU make).
  10. After Mindy has been compiled, type ``make install'' to install it.
  11. (Note: you will need write permission for the directories that files
  12. are being installed to; see below)
  13.  
  14. The default installation directory for executables is /usr/local/bin;
  15. for libraries it is /usr/local/lib/mindy.  You can change the prefix
  16. for these paths from /usr/local to whatever by typing ``configure
  17. --prefix=whatever''.  (It is not a good idea to specify the path name
  18. using a tilda (~) because tilda has a special meaning only in csh.
  19. make uses sh, so tildas probably won't do what you want them to)
  20.  
  21. If you want to build Mindy in one-place while the sources are
  22. kept in another-place, then type ``cd one-place;
  23. another-place/configure --srcdir=another-place'' and configure will
  24. construct the appropriate directories and Makefiles.
  25.  
  26. Other options may be provided directly to make:
  27.  
  28.     CC    specifies the C compiler to use
  29.     CCOPTS    specifies options to pass to the C compiler
  30.     YACC    specifies the parser generator
  31.     LEX    specifies the lexer generator
  32.     LFLAGS    specifies the flags passed to LEX
  33.  
  34. The default C compiler options (CCOPTS) are ``-g -O4
  35. -finline-functions -Wall'' if you are using gcc, ``-g -O'' otherwise.
  36. If you are not using gcc, we *highly* recommend you read the man page
  37. for your compiler and supply the flags that ask for the maximum
  38. optimization.  (Note that on many compilers, -g, "generate debugging
  39. information", and -O, "optimize", are mutually exclusive.  If you have
  40. to choose between the two, go with optimization.)
  41.  
  42. Options can be passed to make by using environment variables: Using
  43. /bin/sh, ``VARNAME=option make -e'' (-e tells make to look at the
  44. environment variables).  Under gmake, options can also be passed via
  45. the command line: ``gmake VARNAME=option''.
  46.  
  47. You can clean up any previously made object files and executables 
  48. with ``make clean''.
  49.  
  50. Here's what a sample installation might look like:
  51.         /bin/sh           # Need the Bourne shell to pass options to make
  52.     ./configure --srcdir=/usr/bob/mindy/src --prefix=/usr/bob/mindy
  53.     CCOPTS="-g -O3" make -e
  54.     make install
  55.     exit              # exit the shell you just launched
  56. This would install binaries to /usr/bob/bin, and library files to
  57. /usr/bob/lib/mindy.
  58.     
  59. Mindy has been successfully built on the following platforms:
  60.     Hardware    OS        Compiler
  61.     --------    --        --------
  62.     HP Apollo    HPUX 9.03    gcc
  63.     DEC pmax     Mach 2.6    gcc
  64.     DEC pmax    Ultrix 4.x    gcc
  65.     SGI         IRIX 4.0.5     gcc and sgi-cc
  66.     SGI         IRIX 5.2     sgi-cc
  67.     Sun         SunOS 4.11    gcc
  68.     PC clone     Linux           gcc
  69.  
  70. If you have successfully compiled Mindy on another architecture,
  71. please send mail to
  72.     gwydion-bugs@cs.cmu.edu
  73. and we will add that architecture to the list.  Please include the
  74. operating system version and what compiler you used.  If changes were
  75. required, please send diffs as well.
  76.  
  77. Mindy can *not* be built out of the box on the DEC Alpha.  If you
  78. would like to port Mindy to the Alpha or any other architecture where
  79. Mindy does not easily compile for, send mail to
  80. gwydion-bugs@cs.cmu.edu and we will try to provide as much help as we
  81. can.
  82.  
  83.  
  84.                     Mindy Trouble Shooting Tips             
  85.  
  86.  
  87. + When I went to `make install' I got permission denied errors.
  88.  
  89.   You need to be the super user to install into /usr/local. Become the
  90.   super user, or ask you system admin to do it for you, or pick an
  91.   unprivileged  location, eg your home directory, and do the install
  92.   there with `prefix=$HOME make -e install'. 
  93.  
  94. + When I tried `prefix=$HOME make -e install' the shell said
  95.   `prefix=$HOME: Command not found'.
  96.  
  97.   You're running a C shell, while our instructions tell you how to pass
  98.   local environment bindings using the Bourne shell (/bin/sh).  You can
  99.   run the standard /bin/sh and repeat the procedure, or you may set the
  100.   environments globally with the C shell `setenv' command before running
  101.   make.
  102.  
  103. + When I went to `make install' I got `cannot unlink' errors.
  104.  
  105.   The install.sh script is trying to rename the files rather than
  106.   copying them.  Try `MVPROG=cp make install'. 
  107.  
  108. + When I went to `make' the compiler choked making compat/sigaction.o.
  109.  
  110.   Your machine does not have a POSIX signal handling package, and the
  111.   default fallback to BSD signal handling didn't work either.  You can
  112.   try the System V emulation by adding -DUSG_SIGNALS to the options used
  113.   to compile sigaction.o.  Alternatively, there may be some magic word
  114.   that is needed to open up the BSD compatability on your system.  Look
  115.   in /usr/include/signal.h and see if it gives any clues.
  116.  
  117. + Everything went fine until the final linking step for mindy or
  118.   mindycomp, then I got a message about undefined symbols.
  119.  
  120.   You've found a hole in our compat library.  It could be easy or
  121.   difficult to fix.  Send mail to
  122.     gwydion-bugs@cs.cmu.edu
  123.   Please include the operating system version and what compiler you
  124.   used.
  125.  
  126. + I'm compiling Mindy, and I get this error:
  127.     ld: driver.o: relocation format botch (symbol type))
  128.     collect2: ld returned 4 exit status
  129.  
  130.   You are probably using a version of gcc earlier than 2.6.0.  Get a
  131.   newer version of gcc, or try a different compiler.
  132.